package com.ruoyi.quartz.service;

import com.ruoyi.common.exception.job.TaskException;
import com.ruoyi.quartz.domain.IotJob;
import org.quartz.SchedulerException;

import java.util.List;

/**
 * 定时任务Service接口
 * 
 * @author changkang
 * @date 2025-05-01
 */
public interface IIotJobService {
    /**
     * 查询定时任务
     * 
     * @param id 定时任务主键
     * @return 定时任务
     */
    public IotJob selectIotJobById(Long id);

    /**
     * 查询定时任务列表
     * 
     * @param iotJob 定时任务
     * @return 定时任务集合
     */
    public List<IotJob> selectIotJobList(IotJob iotJob);

    /**
     * 新增定时任务
     * 
     * @param iotJob 定时任务
     * @return 结果
     */
    public int insertIotJob(IotJob iotJob) throws SchedulerException, TaskException;

    /**
     * 修改定时任务
     * 
     * @param iotJob 定时任务
     * @return 结果
     */
    public int updateIotJob(IotJob iotJob) throws SchedulerException, TaskException;

    public int changeStatus(IotJob iotJob) throws SchedulerException, TaskException;


    /**
     * 立即运行任务
     *
     * @param iotJob 调度信息
     * @return 结果
     */
    public boolean run(IotJob iotJob) throws SchedulerException;

    /**
     * 批量删除定时任务
     * 
     * @param ids 需要删除的定时任务主键集合
     * @return 结果
     */
    public int deleteIotJobByIds(Long[] ids) throws SchedulerException;

    /**
     * 删除定时任务信息
     * 
     * @param id 定时任务主键
     * @return 结果
     */
    public int deleteIotJobById(Long id) throws SchedulerException;
}
